home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / amax.z / amax
Encoding:
Text File  |  2002-10-03  |  2.8 KB  |  90 lines
  1. AMAX(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      IISSAAMMAAXX, IIDDAAMMAAXX, IICCAAMMAAXX, IIZZAAMMAAXX - Searches a vector for the first
  6.      occurrence of the maximum absolute value
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         _i_n_d_e_x = IISSAAMMAAXX ((_n,, _x,, _i_n_c_x))
  12.  
  13.      Double precision
  14.  
  15.         _i_n_d_e_x = IIDDAAMMAAXX ((_n,, _x,, _i_n_c_x))
  16.  
  17.      Complex
  18.  
  19.         _i_n_d_e_x = IICCAAMMAAXX ((_n,, _x,, _i_n_c_x))
  20.  
  21.      Double complex
  22.  
  23.         _i_n_d_e_x = IIZZAAMMAAXX ((_n,, _x,, _i_n_c_x))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      IISSAAMMAAXX/IIDDAAMMAAXX searches a real vector for the first occurrence of the
  30.      maximum absolute value.
  31.  
  32.      IICCAAMMAAXX/IIZZAAMMAAXX searches a complex vector for the first occurrence of
  33.      the maximum absolute value.
  34.  
  35.      IISSAAMMAAXX returns the first index _i such that
  36.  
  37.           |_x | = MMAAXX |_x | : _j = 1, ..., _n
  38.             _i          _j
  39.  
  40.      where _x  is an element of a real vector.
  41.             _j
  42.  
  43.      IICCAAMMAAXX determines the first index _i such that
  44.  
  45.           ||_R_e_a_l(_x )|+ |_I_m_a_g(_x ) | =
  46.                   _i           _i
  47.  
  48.           MMAAXX(|_R_e_a_l(_x )| + | _I_m_a_g(_x )|): _j = 1, ..., _n
  49.                      _j             _j
  50.      where _x  is an element of a complex vector.
  51.             _j
  52.  
  53.      These functions have the following arguments:
  54.  
  55.      _i_n_d_e_x Integer.  (output)
  56.            First index of maximum absolute value.
  57.  
  58.      _n     Integer.  (input)
  59.            Number of elements to process in the vector to be searched.  If
  60.            _n <= 0, these routines return 0.
  61.  
  62.      _x     Array of dimension (_n-1) * |_i_n_c_x|+1.  (input)
  63.            IISSAAMMAAXX: Real array.
  64.            IIDDAAMMAAXX: Double precision array.
  65.            IICCAAMMAAXX: Complex array.
  66.            IIZZAAMMAAXX: Double complex array.
  67.  
  68.            Array _x contains the vector to be searched.
  69.  
  70.      _i_n_c_x  Integer.  (input)
  71.            Increment between elements of _x.
  72.  
  73. NNOOTTEESS
  74.      When scanning backward (_i_n_c_x < 0), each routine starts at the end of
  75.      the vector and moves backward, as follows:
  76.  
  77.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  78.  
  79.      The largest absolute value is:
  80.  
  81.           AABBSS (_x(1+(_i_n_d_e_x-1) * _i_n_c_x)) when _i_n_c_x > 0
  82.  
  83.           AABBSS (_x(1+(_n-_i_n_d_e_x) * |_i_n_c_x|)) when _i_n_c_x < 0
  84.  
  85.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  86.      BLAS).
  87.  
  88. SSEEEE AALLSSOO
  89.      This man page is available only online.
  90.